home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / utils / pgrabt10 / readme.doc < prev    next >
Text File  |  1994-05-30  |  8KB  |  168 lines
  1.  
  2.  
  3. [GENERAL]
  4.  
  5. This is a new picture grabber with some sort of the pre-TIFF editor. Current
  6. version is 1.0, file PGRABT10.ZIP. Contents of the ZIP file:
  7.         PGRAB.EXE  (the grabber)
  8.         TIFFC.EXE  (TIFF converter)
  9.         README.DOC (this file)
  10.         VIDEO.AUX  (example to be converted to TIFF file format)
  11.         VIDEO.TIF  (the same picture as above)
  12.  
  13. [PURPOSE]
  14.  
  15. Various grabbers are available, but I haven't come across to the one
  16. which would completely satisfied the need to *easyly* transfer a figure 
  17. produced by some MSDOS program to the particular word processor. Or 
  18. to some UN*X workstation. Also the picture (or figure) sometimes cannot
  19. be transfered as it is, because there is no color printer attached to
  20. the word processor available. Therefore you have to be able to greyscale 
  21. your picture and you should be able to adjust outgoing colors or shades 
  22. of grey for your paper.
  23.  
  24.  
  25. [FUNCTIONING]
  26.  
  27. The grabber itself detects the video mode and the graphics card. It has
  28. been tested with HERCULES and some VGA cards in the most used graphics
  29. modes. 
  30. You can grab any part (or whole) of the screen into one *.AUX file, each
  31. subsequently stored file image will be given an *.001 to *.999 extension.
  32. What is stored? The picture image along with the palette - R, G, B triplets
  33. for each pixel's index. This 'undefined' image file format than can be
  34. converted to the TIFF file format with the TIFF converter. Great many word 
  35. processors do support TIFF file format, so this format was chosen. 
  36. The converter provides you with the ability to *grey scale* the picture, 
  37. which then can be easyly printed on your HP LaserJet, Epson or 
  38. what_ever_your_word_processor_support printer.
  39. Of course, if you have any of the color printers, you may exchange the
  40. colors as well, before converting to TIFF file. 
  41. The PGRABT was tested with WordPerfect 5.1, WordPerfect 5.2 for Windows, 
  42. MS Word for Win 2.0 and some TIFF and X-TIFF readers. 
  43.  
  44.  
  45. [HOWITWORKS]
  46.  
  47. PGRAB is the resident utility which should be started from the command
  48. line or a batch file, under the MSDOS 3.1 or above in the following manner:
  49.  
  50.         C:\BIN>PGRAB 
  51.  
  52. One may load the resident utility above 640K, on MSDOS 5.0 or later, by 
  53. issuing LOADHIGH command: C:\BIN>LOADHIGH PGRAB.
  54. It will inform you that the installation was successful and ask you about
  55. the file name for storing images, offering the default.
  56. The hot-key for the activation is:
  57.  
  58.         CTRL + Left_SHIFT
  59.  
  60. If you try this in one of the text modes, you'll receive the informing 
  61. message that there is no image to store, and that you should start the
  62. PGRAB only in one of the graphics modes.
  63. PGRAB also uses DOS's multiplex interrupt 2Fh, function C4h.
  64. The rectangle appears in the middle of the screen. Commands are:
  65.  
  66.         Cursor keys (Up, Down, Left, Right) - for moving around
  67.         PgUp - increase the size of the rectangle in the vertical direction
  68.         PgDown - decrease the size of the rectangle in the vertical direction
  69.         Home - increase the size of the rectangle in the horizontal direction
  70.         End  - decrease the size of the rectangle in the horizontal direction
  71.         Insert - incrementing the sizing and moving step
  72.         Delete - decrementing the sizing and moving step
  73.         Enter  - accepting the area under the rectangle to be stored into the 
  74.                  *.AUX file
  75.         Esc    - aborting the procedure
  76.  
  77. To uninstall the PGRAB, you just have to type:
  78.  
  79.         C:\BIN>PGRAB -r
  80.  
  81. It will inform you whether the uninstallation was successful or not. 
  82. If not, the PGRAB deactivates itself only.
  83.  
  84. TIFFC is even more simple. You can start this converter as follows:
  85.  
  86. C:\BIN>TIFFC video.aux video.tif
  87.  
  88. Try that with the video.aux file that comes along this zip file! 
  89. Obviously, the first argument is the name of the *.aux file, and the 
  90. second is the outgoing TIFF file. 
  91. Converter then asks you whether you want the color picture or grey
  92. scale. If you choose greyscale, next question is concerning the
  93. treatment of the greyscaling. Either it can be regarded as a special
  94. case of the TIFF file with the palette (R, G, B values are same for
  95. each pixel's index and increase with the index) or as 'pure' greyscale
  96. TIFF file. Why is that so? Because some word processors (WP51...) doesn't
  97. handle the TIFF file with the palette in the appropriate manner. So
  98. you should use 'pure' greyscale TIFF file. Try! 
  99.  
  100. Index exchanging or changing the RGB values for each pixel's index was
  101. implemented as user friendly as that was possible. Keys for changing the 
  102. RGB values (i.e. the colors of each pixel's index) are:
  103.  
  104.         Enter -  changing the value of the particular color
  105.         Space -  changing the color component (red, green or blue)
  106.         Tab   -  increasing the values for all three components r, g & b by 1
  107.         Up, Down - choosing indexes, from 0 to maxcol, and back
  108.         Esc   - accepting these changes and storing the TIFF file.
  109.  
  110. For index exchanging - when you want your grey-scaled picture look nicer and
  111. more accurate, but you are able to use only indexes for greyscaling (let's 
  112. say from 0-15), and not the RGB values (TIFF with the palette), commands
  113. follows:
  114.         Tab   -  exchanging the shade of grey from 0 to maxcol (15)
  115.         Up, Down - choosing pixel's index
  116.         Esc   -  discard any changes, and saving the TIFF file as it
  117.                  was the picture
  118.         Enter -  accepting new grey shades, and saving the TIFF file.
  119.  
  120.  
  121. [KNOWN PROBLEMS]
  122.  
  123. Huge PGRABT's resident portion. 
  124.  The PGRAB was compiled with BC & TASM what produced large EXE file. 
  125.  Perhaps I should have better determined number of paragraphs prior to the
  126.  DOS terminate-and-stay resident call. Or avoided mixing C and ASM
  127.  and worked out everything in pure assembly language and not giving
  128.  so big stack/heap space to the resident part (about 9.5K).
  129.  For now, the resident part can be easyly uninstall 
  130.  with  -r option, when needed.
  131.  
  132. TIFF file with odd numbers of pixels per row and four bits per pixel. 
  133. Cannot be read with some old TIFF file dumpers on MSDOS.
  134.  Reprogram the process of grabbing a figure so it stores an even number
  135.  of pixels or 8 bits per pixel in every case. Will be certainly done in 
  136.  the future versions.
  137.  (Tnx to Mr. Dan McCoy [mccoy@pixar.com] who explained this)
  138.  
  139. X-TIFF reader doesn't accept compressed (PackedBit compression) TIFF file.
  140.   When TIFF file is being compressed, some strip offsets become invalid and 
  141.   should be adjusted during the compression. But, that didn't bother any 
  142.   of the DOS word processor's TIFF file reader!
  143.  
  144. Sound on some slow i286 machines or 'slow' graphics cards irritates.
  145.  Will be added an option to skip producing continuous sound. Insted,
  146.  the grabber will skip some and produce every 10th part or so. So
  147.  that the beeping won't be so irritating.
  148.  
  149.  
  150. [REMARKS]
  151.  
  152. If you have some articles/papers to write, I think the PGRABT would be of 
  153. great help for you.
  154. This software is in public domain, it can be freely copied and distributed.
  155. Sources and detailed technical descriptions are not the part of this zip
  156. file. I don't won't to bother some end-user with those details. However, 
  157. they are available upon a request.
  158. I would appreceate if you send me an e-mail to notify that you have tried 
  159. the PGARBT along with your opinion and/or comment ( or a smile :). 
  160. My address is:
  161. roby@math.hr 
  162.                                          home snail address:
  163. Robertino Benis                              
  164. Dept. of Math., UniZg,                       Kapucinska 33
  165. Bijenicka c. 30                              41040 Zagreb 
  166. Zagreb, Croatia                              Croatia
  167.  
  168.